home *** CD-ROM | disk | FTP | other *** search
/ HyperLib 1997 Winter - Disc 1 / HYPERLIB-1997-Winter-CD1.ISO.7z / HYPERLIB-1997-Winter-CD1.ISO / オンラインウェア / PRG / Convert･Projects 1.0b6.sit / Convert•Projects 1.0b6 / About Convert•Projects next >
Text File  |  1994-09-17  |  9KB  |  234 lines
  1. (This file was created by BBEdit 3.0, a product of Bare Bones Software.
  2. It was written in Monaco 9, with four spaces per tab.)
  3.  
  4. This document is current as of -prerelease- version 1.0b6 of the
  5. software, written on September 17, 1994.
  6.  
  7. [Prerelease note: As of 1.0b6, the following limitations apply:
  8.         
  9. -    We ･strongly･ recommend that before converting a project,
  10.     that you do a full scan of the source files. To do this,
  11.     choose the ﾒMake...ﾓ command from the THINK Project Managerﾕs
  12.     ﾒSourceﾓ menu, un-check the ﾒQuick Scanﾓ check box in the
  13.     dialog, click ﾒUse Diskﾓ, and when the scan is complete,
  14.     click ﾒDonﾕt Makeﾓ.
  15.     
  16.     If you donﾕt do this, you risk running afoul of a bug in
  17.     the TPM which will cause garbage file names to be returned
  18.     to Convert･Projects.
  19.     
  20. This version is a ﾒpublic betaﾓ; it is substantially feature-complete,
  21. and does what it says it does. It is in need of real field-testing, so
  22. if you have problems using it that arenﾕt covered here, or if you
  23. run into anomalous behavior, please contact us (preferably via e-mail).
  24. ]
  25.  
  26. About Convert･Projects
  27. ----- ----------------
  28.  
  29. Convert･Projects is a utility which will read a THINK C or THINK Pascal
  30. product, and produce an equivalent (or nearly so) Code Warrior project.
  31. This is particularly useful for large projects, in which manually
  32. adding and segmenting the project would be tiresome or impractical.
  33.  
  34. Convert･Projects does not modify the project documents you feed it,
  35. so you can continue to use them, should the need arise.
  36.  
  37. With Convert･Projects, you can convert THINK Pascal version 4.0 or
  38. later, and THINK C version 6.0 or later (including Symantec C++ 6.0)
  39. project documents.
  40.  
  41. How to Use Convert･Projects
  42. --- -- --- ----------------
  43.  
  44. Using Convert･Projects is easy - just drag & drop your project
  45. document(s) onto the Convert･Projects icon. Convert･Projects will read
  46. in your THINK C or THINK Pascal project document, locate and analyze the
  47. files, and produce a Code Warrior project. Subject to the preferences
  48. settings (see below), more than one project may be produced, e.g. one
  49. for 68K and one for PowerPC.
  50.  
  51. Some files cannot be used by Code Warrior. Specifically, Code Warrior
  52. cannot (and will never be able to) load THINK C project documents that
  53. are included as libraries (the ANSI libraries are an example of this);
  54. ﾒstandardﾓ THINK C library files (created with ﾒBuild Libraryﾓ) likewise
  55. cannot be used by Code Warrior, nor can library files created in the MPW
  56. ".O" format (including THINK Pascal 3.0 or later library files).
  57. Convert･Projects will exclude these libraries when writing out the new
  58. project, and will advise you of the libraries that have been excluded.
  59. Itﾕs up to you to reconstitute those libraries - if the source is
  60. available, then include the source directly in the Code Warrior project;
  61. otherwise, contact the library vendor for a version that works with Code
  62. Warrior.
  63.  
  64. Preferences Settings
  65. ----------- --------
  66.  
  67. Convert･Projects provides the following settings in its ﾒPreferencesﾓ 
  68. dialog:
  69.  
  70. -    Emit 68K Project: If checked, Convert･Projects will write out a
  71.                         project usable by the 68K versions of the
  72.                         Code Warrior environment.
  73.                         
  74. -    Emit PowerPC Project: If checked, Convert･Projects will write out a
  75.                         project usable by the PowerPC versions of the
  76.                         Code Warrior environment.
  77.                         
  78. -    Remove Missing Files: If checked, Convert･Projects will filter out
  79.                         files that it couldnﾕt locate when loading 
  80.                         the THINK-format project, and advise you
  81.                         of the files that have been filtered.
  82.                         
  83. -    Add Standard Libraries: If checked, standard libraries (ANSI.Lib for
  84.                         Code Warrior C & C++, MW/Runtime.Lib for Code Warrior
  85.                         Pascal) will be added to the created project.
  86.                         
  87. -    Add Toolbox Glue: If checked, toolbox glue (MacOS.Lib) will be added
  88.                         to the created project.
  89.  
  90. -    Ask for Project Name: If checked, Convert･Projects will always ask you
  91.                         (via Standard File) to specify the name and location
  92.                         of each project that it writes out. Although this
  93.                         compromises the drag-and-drop-ness of the utility,
  94.                         it can occasionally be useful.
  95.  
  96. Limitations
  97. -----------
  98.  
  99. The following limitations apply when using Convert･Projects:
  100.  
  101. -    Convert･Projects uses the services of the THINK Project Manager to
  102.     determine the files and segmentation of a THINK C project. For this
  103.     reason, youﾕll need enough memory so that Convert･Projects can launch
  104.     the THINK Project Manager.
  105.  
  106. -    Although it automates part of the conversion process, Convert･Projects
  107.     is -not- a ﾒmagic bulletﾓ that will get you up and running with Code
  108.     Warrior in minutes. How long it takes you to get your programs ported
  109.     depends on the nature of your code.
  110.     
  111. -    Convert･Projects is not, nor will it ever be, able to convert library
  112.     files from THINK or MPW formats to the Code Warrior format. If you
  113.     have a library which is not available in source or Code Warrior
  114.     library form, contact the vendor of the library.
  115.     
  116. -    Convert･Projects makes a reasonable effort to locate the files
  117.     specified in the input projects, and to write out projects such that
  118.     Code Warrior can readily find the source files. To help this process,
  119.     we recommend that you build the project you want to convert, so that
  120.     all source filesﾕ locations can be determined. (If youﾕre using THINK
  121.     C, bring up the ﾒMake...ﾓ dialog, turn off the ﾒQuick Scanﾓ check box,
  122.     and click the ﾒUse Diskﾓ button.)
  123.  
  124. -    Depending on the arrangement of your directory structures, you may need
  125.     to add some search paths to the Code Warrior project so that Code
  126.     Warrior can locate all of the files in that project.
  127.     
  128. -    Convert･Projects does not address the issue of resource files; Code
  129.     Warrior uses the same convention as THINK C for naming the projectﾕs
  130.     resource file; you should make a duplicate of your resource file and
  131.     give it the correct name after converting your project.
  132.     
  133.  
  134. Miscellaneous Comments
  135. ------------- --------
  136.  
  137. -    Convert･Projects is free.
  138.  
  139. -    We plan to keep Convert･Projects up to date as necessary to accomodate
  140.     changes to Code Warrior. Therefore, if you have problems with
  141.     Convert･Projects, please let us know so that we can resolve them.
  142.     If Code Warrior has difficulty with a project that Convert･Projects
  143.     creates, or if Convert･Projects has difficulty processing your
  144.     projects, we definitely want to know about it.
  145.  
  146. -    Please note that we have no plans to turn Convert･Projects into a
  147.     source converter, and we cannot offer assistance with porting your code
  148.     to work with Code Warrior.
  149.     
  150. -    If you have questions or problems with Convert･Projects, please contact
  151.     us by one of the following means:
  152.     
  153.     Internet: bbsw@netcom.com
  154.     CIS: 73051,3255
  155.     AppleLink: BARE.BONES
  156.     Fax: (508) 651-7584
  157.     Phone: (508) 651-3561
  158.     Mail:        Bare Bones Software, Inc.
  159.                 P.O. Box 108
  160.                 Bedford, MA 01730
  161.  
  162. Attributions
  163. ------------
  164.  
  165. Convert･Projects was written by Rich Siegel.
  166.  
  167. Convert･Projects is based on Drop･Shell, which was written by
  168. Leonard Rosenthol, Marshall Clow, and Stephan Somogyi.
  169.  
  170. Thanks to Greg Galanos and Berardino Baratta of Metrowerks, and
  171. to John McEnerney, for their assistance.
  172.     
  173. Copyright & Distribution Information
  174. --------- - ------------ -----------
  175.  
  176. Convert･Projects is written by and copyright ｩ1994 Bare Bones Software, Inc.;
  177. all rights reserved.
  178.  
  179. This software may be redistributed under the following conditions:
  180.  
  181. -    Convert･Projects may not be sold, either by itself or in combination
  182.     with any other product, without the express written permission of
  183.     Richard M. Siegel.
  184.     
  185. -    This document and the Convert･Projects application must be distributed
  186.     together, in the same directory on a Finder-mountable volume, or in the
  187.     same compressed-file (e.g. StuffIt or Compact Pro) archive.
  188.     
  189. -    The Convert･Projects package may be freely posted to any BBS or
  190.     information service which charges its users for general connect and
  191.     downloading time; the package may -not- be posted to any BBS or
  192.     information service which will charge for the specific right to
  193.     download Convert･Projects.
  194.     
  195. -    Commercial publishers and distributors of CD-ROM software collections
  196.     may not include the Convert･Projects package without the express
  197.     written permission of Richard M. Siegel.
  198.  
  199. About Bare Bones Software
  200. ----- ---- ----- --------
  201.  
  202. Bare Bones Software, founded in May 1993, is the developer and publisher
  203. of the following software:
  204.  
  205. -    BBEdit, the best-of-class text editor for programmers, on-line
  206.     service users, and anyone else who needs to edit ASCII text files with
  207.     maximum performance and minimum fuss. BBEdit 3.0 features integration
  208.     with THINK C/Symantec C++ 6.0, THINK Reference, MPW ToolServer, and
  209.     support for THINK Pascal and Code Warrior projects, native PowerPC
  210.     code for maximum performance, support for emerging system-software
  211.     technologies such as Macintosh Drag and Drop, OSA, and PowerTalk,
  212.     as well as an assortment of unique and powerful features.
  213.     Write for a free demo disk.
  214.     
  215. -    BBEdit Lite, the popular freeware version of BBEdit.
  216.  
  217. -    Convert･Projects, a freeware utility to convert THINK C and THINK
  218.     Pascal project documents to Metrowerks Code Warrior format.
  219.     
  220. -    Drop･PS, a freeware PostScriptｪ downloader for network-connected
  221.     printers.
  222.  
  223. For additional information, contact us at one of these addresses:
  224.  
  225. Internet: bbsw@netcom.com
  226. CIS: 73051,3255
  227. AppleLink: BARE.BONES
  228. Fax: (508) 651-7584
  229. Phone: (508) 651-3561
  230. Mail:
  231.     Bare Bones Software, Inc.
  232.     P.O. Box 108
  233.     Bedford, MA 01730
  234.